home *** CD-ROM | disk | FTP | other *** search
/ Freaks Macintosh Archive / Freaks Macintosh Archive.bin / Freaks Macintosh Archives / Crypto⁄Encryption / PGP / PowerMac601 PGP 2.6.3i.sit / PowerMac601 PGP 2.6.3i / Volume I < prev    next >
Text File  |  1995-02-26  |  84KB  |  1,821 lines

  1.  
  2.  
  3.                 Phil's Pretty Good Software
  4.                         Presents
  5.  
  6.                         =======
  7.                           PGP™
  8.                         =======
  9.  
  10.                     Pretty Good™ Privacy
  11.             Public Key Encryption for the Masses
  12.  
  13.  
  14.                 --------------------------
  15.                     PGP™ User's Guide
  16.                 Volume I: Essential Topics
  17.                 --------------------------
  18.                      by Philip Zimmermann
  19.                     Revised  11 October 94
  20.  
  21.  
  22.                 PGP Version 2.6.2 - 11 Oct 94
  23.                         Software by
  24.             Philip Zimmermann, and many others.
  25.  
  26.  
  27.  
  28.  
  29. Synopsis:  PGP™ uses public-key encryption to protect E-mail and
  30. data files.  Communicate securely with people you've never met, with
  31. no secure channels needed for prior exchange of keys.  PGP is well
  32. featured and fast, with sophisticated key management, digital
  33. signatures, data compression, and good ergonomic design.
  34.  
  35.  
  36. Software and documentation © Copyright 1990-1994 Philip Zimmermann.
  37. All rights reserved.  For information on PGP licensing, distribution,
  38. copyrights, patents, trademarks, liability limitations, and export
  39. controls, see the "Legal Issues" section in the "PGP User's Guide,
  40. Volume II: Special Topics".  Distributed by the Massachusetts
  41. Institute of Technology.
  42.  
  43.  
  44. "Whatever you do will be insignificant, but it is very important that
  45. you do it."  --Mahatma Gandhi
  46.  
  47.  
  48.  
  49. Contents
  50. ========
  51.  
  52. Quick Overview
  53. Why Do You Need PGP?
  54. How it Works
  55. Installing PGP
  56. How to Use PGP
  57.   To See a Usage Summary
  58.   Encrypting a Message
  59.   Encrypting a Message to Multiple Recipients
  60.   Signing a Message
  61.   Signing and then Encrypting
  62.   Using Just Conventional Encryption
  63.   Decrypting and Checking Signatures
  64.   Managing Keys
  65.     RSA Key Generation
  66.     Adding a Key to Your Key Ring
  67.     Removing a Key or User ID from Your Key Ring
  68.     Extracting (copying) a Key from Your Key Ring
  69.     Viewing the Contents of Your Key Ring
  70.     How to Protect Public Keys from Tampering
  71.     How Does PGP Keep Track of Which Keys are Valid?
  72.     How to Protect Secret Keys from Disclosure
  73.     Revoking a Public Key
  74.     What If You Lose Your Secret Key?
  75. Advanced Topics
  76.   Sending Ciphertext Through E-mail Channels: Radix-64 Format
  77.   Environmental Variable for Path Name
  78.   Setting Parameters in the PGP Configuration File
  79. Vulnerabilities
  80. Beware of Snake Oil
  81. Notice to Macintosh Users
  82. PGP Quick Reference
  83. Legal Issues
  84. Acknowledgments
  85. About the Author
  86.  
  87.  
  88.  
  89. Quick Overview
  90. ==============
  91.  
  92. Pretty Good™ Privacy (PGP), from Phil's Pretty Good Software, is a
  93. high security cryptographic software application for MSDOS, Unix,
  94. VAX/VMS, and other computers.  PGP allows people to exchange files or
  95. messages with privacy, authentication, and convenience.  Privacy
  96. means that only those intended to receive a message can read it. 
  97. Authentication means that messages that appear to be from a
  98. particular person can only have originated from that person. 
  99. Convenience means that privacy and authentication are provided
  100. without the hassles of managing keys associated with conventional
  101. cryptographic software.  No secure channels are needed to exchange
  102. keys between users, which makes PGP much easier to use.  This is
  103. because PGP is based on a powerful new technology called "public key"
  104. cryptography.  
  105.  
  106. PGP combines the convenience of the Rivest-Shamir-Adleman (RSA)
  107. public key cryptosystem with the speed of conventional cryptography,
  108. message digests for digital signatures, data compression before
  109. encryption, good ergonomic design, and sophisticated key management. 
  110. And PGP performs the public-key functions faster than most other
  111. software implementations.  PGP is public key cryptography for the
  112. masses.
  113.  
  114. PGP does not provide any built-in modem communications capability. 
  115. You must use a separate software product for that.
  116.  
  117. This document, "Volume I: Essential Topics", only explains the
  118. essential concepts for using PGP, and should be read by all PGP
  119. users.  "Volume II: Special Topics" covers the advanced features of
  120. PGP and other special topics, and may be read by more serious PGP
  121. users.  Neither volume explains the underlying technology details of
  122. cryptographic algorithms and data structures.  
  123.  
  124.  
  125.  
  126. Why Do You Need PGP?
  127. ====================
  128.  
  129. It's personal.  It's private.  And it's no one's business but yours.
  130. You may be planning a political campaign, discussing your taxes, or
  131. having an illicit affair.  Or you may be doing something that you
  132. feel shouldn't be illegal, but is.  Whatever it is, you don't want
  133. your private electronic mail (E-mail) or confidential documents read
  134. by anyone else.  There's nothing wrong with asserting your privacy. 
  135. Privacy is as apple-pie as the Constitution.  
  136.  
  137. Perhaps you think your E-mail is legitimate enough that encryption is
  138. unwarranted.  If you really are a law-abiding citizen with nothing to
  139. hide, then why don't you always send your paper mail on postcards? 
  140. Why not submit to drug testing on demand?  Why require a warrant for
  141. police searches of your house?  Are you trying to hide something? 
  142. You must be a subversive or a drug dealer if you hide your mail
  143. inside envelopes.  Or maybe a paranoid nut.  Do law-abiding citizens
  144. have any need to encrypt their E-mail?
  145.  
  146. What if everyone believed that law-abiding citizens should use
  147. postcards for their mail?  If some brave soul tried to assert his
  148. privacy by using an envelope for his mail, it would draw suspicion. 
  149. Perhaps the authorities would open his mail to see what he's hiding. 
  150. Fortunately, we don't live in that kind of world, because everyone
  151. protects most of their mail with envelopes.  So no one draws suspicion
  152. by asserting their privacy with an envelope.  There's safety in
  153. numbers.  Analogously, it would be nice if everyone routinely used
  154. encryption for all their E-mail, innocent or not, so that no one drew
  155. suspicion by asserting their E-mail privacy with encryption.  Think
  156. of it as a form of solidarity.
  157.  
  158. Today, if the Government wants to violate the privacy of ordinary
  159. citizens, it has to expend a certain amount of expense and labor to
  160. intercept and steam open and read paper mail, and listen to and
  161. possibly transcribe spoken telephone conversation.  This kind of
  162. labor-intensive monitoring is not practical on a large scale.  This
  163. is only done in important cases when it seems worthwhile. 
  164.  
  165. More and more of our private communications are being routed through
  166. electronic channels.  Electronic mail is gradually replacing
  167. conventional paper mail.  E-mail messages are just too easy to
  168. intercept and scan for interesting keywords.  This can be done
  169. easily, routinely, automatically, and undetectably on a grand scale. 
  170. International cablegrams are already scanned this way on a large
  171. scale by the NSA. 
  172.  
  173. We are moving toward a future when the nation will be crisscrossed
  174. with high capacity fiber optic data networks linking together all our
  175. increasingly ubiquitous personal computers.  E-mail will be the norm
  176. for everyone, not the novelty it is today.  The Government will
  177. protect our E-mail with Government-designed encryption protocols. 
  178. Probably most people will acquiesce to that.  But perhaps some people
  179. will prefer their own protective measures.
  180.  
  181. Senate Bill 266, a 1991 omnibus anti-crime bill, had an unsettling
  182. measure buried in it.  If this non-binding resolution had become real
  183. law, it would have forced manufacturers of secure communications
  184. equipment to insert special "trap doors" in their products, so that
  185. the Government can read anyone's encrypted messages.  It reads:  "It
  186. is the sense of Congress that providers of electronic communications
  187. services and manufacturers of electronic communications service
  188. equipment shall insure that communications systems permit the
  189. Government to obtain the plain text contents of voice, data, and
  190. other communications when appropriately authorized by law."  This
  191. measure was defeated after rigorous protest from civil libertarians
  192. and industry groups.  
  193.  
  194. In 1992, the FBI Digital Telephony wiretap proposal was introduced to
  195. Congress.  It would require all manufacturers of communications
  196. equipment to build in special remote wiretap ports that would enable
  197. the FBI to remotely wiretap all forms of electronic communication
  198. from FBI offices.  Although it never attracted any sponsors in
  199. Congress in 1992 because of citizen opposition, it was reintroduced in
  200. 1994.  
  201.  
  202. Most alarming of all is the White House's bold new encryption policy
  203. initiative, under development at NSA since the start of the Bush
  204. administration, and unveiled April 16th, 1993.  The centerpiece of
  205. this initiative is a Government-built encryption device, called the
  206. "Clipper" chip, containing a new classified NSA encryption
  207. algorithm.  The Government is encouraging private industry to design
  208. it into all their secure communication products, like secure phones,
  209. secure FAX, etc.  AT&T is now putting the Clipper into their secure
  210. voice products.  The catch:  At the time of manufacture, each Clipper
  211. chip will be loaded with its own unique key, and the Government gets
  212. to keep a copy, placed in escrow.  Not to worry, though-- the
  213. Government promises that they will use these keys to read your
  214. traffic only when duly authorized by law.  Of course, to make Clipper
  215. completely effective, the next logical step would be to outlaw other
  216. forms of cryptography.
  217.  
  218. If privacy is outlawed, only outlaws will have privacy.  Intelligence
  219. agencies have access to good cryptographic technology.  So do the big
  220. arms and drug traffickers.  So do defense contractors, oil companies,
  221. and other corporate giants.  But ordinary people and grassroots
  222. political organizations mostly have not had access to affordable
  223. "military grade" public-key cryptographic technology.  Until now.
  224.  
  225. PGP empowers people to take their privacy into their own hands.  
  226. There's a growing social need for it.  That's why I wrote it.
  227.  
  228.  
  229.  
  230. How it Works
  231. ============
  232.  
  233. It would help if you were already familiar with the concept of
  234. cryptography in general and public key cryptography in particular. 
  235. Nonetheless, here are a few introductory remarks about public key
  236. cryptography.
  237.  
  238. First, some elementary terminology.  Suppose I want to send you a
  239. message, but I don't want anyone but you to be able to read it.  I
  240. can "encrypt", or "encipher" the message, which means I scramble it
  241. up in a hopelessly complicated way, rendering it unreadable to anyone
  242. except you, the intended recipient of the message.  I supply a
  243. cryptographic "key" to encrypt the message, and you have to use the
  244. same key to decipher or "decrypt" it.  At least that's how it works
  245. in conventional "single-key" cryptosystems.
  246.  
  247. In conventional cryptosystems, such as the US Federal Data Encryption
  248. Standard (DES), a single key is used for both encryption and
  249. decryption.  This means that a key must be initially transmitted via
  250. secure channels so that both parties can know it before encrypted
  251. messages can be sent over insecure channels.  This may be
  252. inconvenient.  If you have a secure channel for exchanging keys, then
  253. why do you need cryptography in the first place?
  254.  
  255. In public key cryptosystems, everyone has two related complementary
  256. keys, a publicly revealed key and a secret key (also frequently called
  257. a private key).  Each key unlocks the code that the other key makes. 
  258. Knowing the public key does not help you deduce the corresponding
  259. secret key.  The public key can be published and widely disseminated
  260. across a communications network.  This protocol provides privacy
  261. without the need for the same kind of secure channels that a
  262. conventional cryptosystem requires.
  263.  
  264. Anyone can use a recipient's public key to encrypt a message to that
  265. person, and that recipient uses her own corresponding secret key to
  266. decrypt that message.  No one but the recipient can decrypt it,
  267. because no one else has access to that secret key.  Not even the
  268. person who encrypted the message can decrypt it.  
  269.  
  270. Message authentication is also provided.  The sender's own secret key
  271. can be used to encrypt a message, thereby "signing" it.  This creates
  272. a digital signature of a message, which the recipient (or anyone
  273. else) can check by using the sender's public key to decrypt it.  This
  274. proves that the sender was the true originator of the message, and
  275. that the message has not been subsequently altered by anyone else,
  276. because the sender alone possesses the secret key that made that
  277. signature.  Forgery of a signed message is infeasible, and the sender
  278. cannot later disavow his signature. 
  279.  
  280. These two processes can be combined to provide both privacy and
  281. authentication by first signing a message with your own secret key,
  282. then encrypting the signed message with the recipient's public key. 
  283. The recipient reverses these steps by first decrypting the message
  284. with her own secret key, then checking the enclosed signature with
  285. your public key.  These steps are done automatically by the
  286. recipient's software.
  287.  
  288. Because the public key encryption algorithm is much slower than
  289. conventional single-key encryption, encryption is better accomplished
  290. by using a high-quality fast conventional single-key encryption
  291. algorithm to encipher the message.  This original unenciphered
  292. message is called "plaintext".  In a process invisible to the user, a
  293. temporary random key, created just for this one "session", is used to
  294. conventionally encipher the plaintext file.  Then the recipient's
  295. public key is used to encipher this temporary random conventional
  296. key.  This public-key-enciphered conventional "session" key is sent
  297. along with the enciphered text (called "ciphertext") to the
  298. recipient.  The recipient uses her own secret key to recover this
  299. temporary session key, and then uses that key to run the fast
  300. conventional single-key algorithm to decipher the large ciphertext 
  301. message.
  302.  
  303. Public keys are kept in individual "key certificates" that include
  304. the key owner's user ID (which is that person's name), a timestamp of
  305. when the key pair was generated, and the actual key material.  Public
  306. key certificates contain the public key material, while secret key
  307. certificates contain the secret key material.  Each secret key is
  308. also encrypted with its own password, in case it gets stolen.  A key
  309. file, or "key ring" contains one or more of these key certificates. 
  310. Public key rings contain public key certificates, and secret key
  311. rings contain secret key certificates.  
  312.  
  313. The keys are also internally referenced by a "key ID", which is an 
  314. "abbreviation" of the public key (the least significant 64 bits of 
  315. the large public key).  When this key ID is displayed, only the lower
  316. 32 bits are shown for further brevity.  While many keys may share the
  317. same user ID, for all practical purposes no two keys share the same
  318. key ID.  
  319.  
  320. PGP uses "message digests" to form signatures.  A message digest is a
  321. 128-bit cryptographically strong one-way hash function of the
  322. message.  It is somewhat analogous to a "checksum" or CRC error
  323. checking code, in that it compactly "represents" the message and is
  324. used to detect changes in the message.  Unlike a CRC, however, it is
  325. computationally infeasible for an attacker to devise a substitute
  326. message that would produce an identical message digest.  The message
  327. digest gets encrypted by the secret key to form a signature.  
  328.  
  329. Documents are signed by prefixing them with signature certificates,
  330. which contain the key ID of the key that was used to sign it, a
  331. secret-key-signed message digest of the document, and a timestamp of
  332. when the signature was made.  The key ID is used by the receiver to
  333. look up the sender's public key to check the signature.  The
  334. receiver's software automatically looks up the sender's public key
  335. and user ID in the receiver's public key ring.
  336.  
  337. Encrypted files are prefixed by the key ID of the public key used to
  338. encrypt them.  The receiver uses this key ID message prefix to look
  339. up the secret key needed to decrypt the message.  The receiver's 
  340. software automatically looks up the necessary secret decryption key 
  341. in the receiver's secret key ring.
  342.  
  343. These two types of key rings are the principal method of storing and
  344. managing public and secret keys.  Rather than keep individual keys in
  345. separate key files, they are collected in key rings to facilitate the
  346. automatic lookup of keys either by key ID or by user ID.  Each user
  347. keeps his own pair of key rings.  An individual public key is
  348. temporarily kept in a separate file long enough to send to your
  349. friend who will then add it to her key ring.
  350.  
  351.  
  352.  
  353. Installing PGP
  354. ==============
  355.  
  356. The MSDOS PGP release package comes in a compressed archive file with
  357. a file named in this form: PGPxx.ZIP (each release version has a
  358. different number for the "xx" in the filename).  For example, the
  359. release package for version 2.6 is called PGP26.ZIP.  The archive can
  360. be decompressed with the MSDOS shareware decompression utility
  361. PKUNZIP, or the Unix utility "unzip".  When the PGP release package
  362. is decompressed, several files emerge from it.  One such file, called
  363. README.DOC, should always be read before installing PGP.  This file
  364. contains late-breaking news on what's new in this release of PGP, as
  365. well as information on what's in all the other files included in the
  366. release.
  367.  
  368. If you already have an earlier version of PGP, you should rename it
  369. or delete it, to avoid name conflicts with the new PGP.
  370.  
  371. For full details on how to install PGP, see the separate PGP
  372. Installation Guide, in the file SETUP.DOC included with this release
  373. package.  It fully describes how to set up the PGP directory and your
  374. AUTOEXEC.BAT file and how to use PKUNZIP to install it.  We will just
  375. briefly summarize the installation instructions here, in case you are
  376. too impatient to read the more detailed installation manual right now.
  377.  
  378. To install PGP on your MSDOS system, you have to copy the compressed
  379. archive PGPxx.ZIP file into a suitable directory on your hard disk
  380. (like C:\PGP), and decompress it with PKUNZIP.  For best results, you
  381. should also modify your AUTOEXEC.BAT file, as described elsewhere in
  382. this manual, but you can do that later, after you've played with PGP
  383. a bit and read more of this manual.  If you haven't run PGP before,
  384. the first step after installation (and reading this manual) is to
  385. make a pair of keys for yourself by running the PGP key generation
  386. command "pgp -kg".  Read the "RSA Key Generation" section of the
  387. manual first.
  388.  
  389. Installing on Unix and VAX/VMS is generally similar to installing on
  390. MSDOS, but you may have to compile the source code first.  A Unix
  391. makefile is provided with the source release for this purpose.  
  392.  
  393.  
  394.  
  395. How to Use PGP
  396. ==============
  397.  
  398.  
  399. To See a Usage Summary
  400. ----------------------
  401.  
  402. To see a quick command usage summary for PGP, just type:
  403.  
  404.     pgp -h
  405.  
  406.  
  407.  
  408. Encrypting a Message
  409. --------------------
  410.  
  411. To encrypt a plaintext file with the recipient's public key, type:
  412.  
  413.     pgp -e textfile her_userid
  414.  
  415. This command produces a ciphertext file called textfile.pgp.  A
  416. specific example is:
  417.  
  418.     pgp -e letter.txt Alice
  419. or:
  420.     pgp -e letter.txt "Alice S"
  421.  
  422. The first example searches your public key ring file "pubring.pgp"
  423. for any public key certificates that contain the string "Alice"
  424. anywhere in the user ID field.  The second example would find any
  425. user IDs that contain "Alice S".  You can't use spaces in the string
  426. on the command line unless you enclose the whole string in quotes. 
  427. The search is not case-sensitive.  If it finds a matching public key,
  428. it uses it to encrypt the plaintext file "letter.txt", producing a
  429. ciphertext file called "letter.pgp". 
  430.  
  431. PGP attempts to compress the plaintext before encrypting it, thereby
  432. greatly enhancing resistance to cryptanalysis.  Thus the ciphertext
  433. file will likely be smaller than the plaintext file.
  434.  
  435. If you want to send this encrypted message through E-mail channels,
  436. convert it into printable ASCII "radix-64" format by adding the -a
  437. option, as described later.
  438.  
  439.  
  440.  
  441. Encrypting a Message to Multiple Recipients
  442. -------------------------------------------
  443.  
  444. If you want to send the same message to more than one person, you may
  445. specify encryption for several recipients, any of whom may decrypt the
  446. same ciphertext file.  To specify multiple recipients, just add more
  447. user IDs to the command line, like so:
  448.  
  449.     pgp -e letter.txt Alice Bob Carol
  450.  
  451. This would create a ciphertext file called letter.pgp that could be
  452. decrypted by Alice or Bob or Carol.  Any number of recipients may be
  453. specified.
  454.  
  455.  
  456.  
  457. Signing a Message
  458. -----------------
  459.  
  460. To sign a plaintext file with your secret key, type:
  461.  
  462.     pgp -s textfile [-u your_userid]
  463.  
  464. Note that [brackets] denote an optional field, so don't actually type
  465. real brackets.  
  466.  
  467. This command produces a signed file called textfile.pgp.  A specific 
  468. example is:
  469.  
  470.     pgp -s letter.txt -u Bob
  471.  
  472. This searches your secret key ring file "secring.pgp" for any secret
  473. key certificates that contain the string "Bob" anywhere in the user
  474. ID field.  Your name is Bob, isn't it?  The search is not
  475. case-sensitive.  If it finds a matching secret key, it uses it to
  476. sign the plaintext file "letter.txt", producing a signature file
  477. called "letter.pgp". 
  478.  
  479. If you leave off the user ID field, the first key on your secret
  480. key ring is used as the default secret key for your signature.
  481.  
  482. PGP attempts to compress the message after signing it.  Thus the
  483. signed file will likely be smaller than the original file, which is
  484. useful for archival applications.  However, this renders the file
  485. unreadable to the casual human observer, even if the original message
  486. was ordinary ASCII text.  It would be nice if you could make a signed
  487. file that was still directly readable to a human.  This would be
  488. particularly useful if you want to send a signed message as E-mail.
  489.  
  490. For signing E-mail messages, where you most likely do want the result
  491. to be human-readable, it is probably most convenient to use the
  492. CLEARSIG feature, explained later.  This allows the signature to be
  493. applied in printable form at the end of the text, and also disables
  494. compression of the text.  This means the text is still human-readable
  495. by the recipient even if the recipient doesn't use PGP to check the
  496. signature.  This is explained in detail in the section entitled
  497. "CLEARSIG - Enable Signed Messages to be Encapsulated as Clear Text",
  498. in the Special Topics volume.  If you can't wait to read that section
  499. of the manual, you can see how an E-mail message signed this way
  500. would look, with this example:
  501.  
  502.     pgp -sta message.txt
  503.  
  504. This would create a signed message in file "message.asc", comprised
  505. of the original text, still human-readable, appended with a printable
  506. ASCII signature certificate, ready to send through an E-mail system. 
  507. This example assumes that you are using the normal settings for
  508. enabling the CLEARSIG flag in the config file.
  509.  
  510.  
  511. Signing and then Encrypting
  512. ---------------------------
  513.  
  514. To sign a plaintext file with your secret key, and then encrypt it 
  515. with the recipient's public key:
  516.  
  517.     pgp -es textfile her_userid [-u your_userid]
  518.  
  519. Note that [brackets] denote an optional field, so don't actually type
  520. real brackets.  
  521.  
  522. This example produces a nested ciphertext file called textfile.pgp.
  523. Your secret key to create the signature is automatically looked up in
  524. your secret key ring via your_userid.  Her public encryption key is
  525. automatically looked up in your public key ring via her_userid.  If
  526. you leave off her user ID field from the command line, you will be 
  527. prompted for it.
  528.  
  529. If you leave off your own user ID field, the first key on your secret
  530. key ring is be used as the default secret key for your signature.
  531.  
  532. Note that PGP attempts to compress the plaintext before encrypting
  533. it.
  534.  
  535. If you want to send this encrypted message through E-mail channels,
  536. convert it into printable ASCII "radix-64" format by adding the -a
  537. option, as described later.
  538.  
  539. Multiple recipients may be specified by adding more user IDs to the
  540. command line.
  541.  
  542.  
  543.  
  544. Using Just Conventional Encryption
  545. ----------------------------------
  546.  
  547. Sometimes you just need to encrypt a file the old-fashioned way, with
  548. conventional single-key cryptography.  This approach is useful for
  549. protecting archive files that will be stored but will not be sent to
  550. anyone else.  Since the same person that encrypted the file will also
  551. decrypt the file, public key cryptography is not really necessary. 
  552.  
  553. To encrypt a plaintext file with just conventional cryptography,
  554. type:
  555.  
  556.     pgp -c textfile
  557.  
  558. This example encrypts the plaintext file called textfile, producing a
  559. ciphertext file called textfile.pgp, without using public key
  560. cryptography, key rings, user IDs, or any of that stuff.  It prompts
  561. you for a pass phrase to use as a conventional key to encipher the
  562. file.  This pass phrase need not be (and, indeed, SHOULD not be) the
  563. same pass phrase that you use to protect your own secret key.  Note
  564. that PGP attempts to compress the plaintext before encrypting it.  
  565.  
  566. PGP will not encrypt the same plaintext the same way twice, even if
  567. you used the same pass phrase every time.
  568.  
  569.  
  570.  
  571. Decrypting and Checking Signatures
  572. ----------------------------------
  573.  
  574. To decrypt an encrypted file, or to check the signature integrity of a
  575. signed file:
  576.  
  577.     pgp ciphertextfile [-o plaintextfile]
  578.  
  579. Note that [brackets] denote an optional field, so don't actually type
  580. real brackets.  
  581.  
  582. The ciphertext file name is assumed to have a default extension of
  583. ".pgp".  The optional plaintext output file name specifies where to
  584. put processed plaintext output.  If no name is specified, the
  585. ciphertext filename is used, with no extension.  If a signature is
  586. nested inside of an encrypted file, it is automatically decrypted and
  587. the signature integrity is checked.  The full user ID of the signer
  588. is displayed.
  589.  
  590. Note that the "unwrapping" of the ciphertext file is completely 
  591. automatic, regardless of whether the ciphertext file is just signed,
  592. just encrypted, or both.  PGP uses the key ID prefix in the
  593. ciphertext file to automatically find the appropriate secret
  594. decryption key on your secret key ring.  If there is a nested
  595. signature, PGP then uses the key ID prefix in the nested signature to
  596. automatically find the appropriate public key on your public key ring
  597. to check the signature.  If all the right keys are already present on
  598. your key rings, no user intervention is required, except that you
  599. will be prompted for your password for your secret key if necessary. 
  600. If the ciphertext file was conventionally encrypted without public
  601. key cryptography, PGP recognizes this and prompts you for the pass
  602. phrase to conventionally decrypt it.
  603.  
  604.  
  605.  
  606. Managing Keys
  607. =============
  608.  
  609. Since the time of Julius Caesar, key management has always been the
  610. hardest part of cryptography.  One of the principal distinguishing
  611. features of PGP is its sophisticated key management.  
  612.  
  613.  
  614.  
  615. RSA Key Generation
  616. ------------------
  617.  
  618. To generate your own unique public/secret key pair of a specified
  619. size, type:  
  620.  
  621.     pgp -kg
  622.  
  623. PGP shows you a menu of recommended key sizes (low commercial grade,
  624. high commercial grade, or "military" grade) and prompts you for what
  625. size key you want, up to more than a thousand bits.  The bigger the
  626. key, the more security you get, but you pay a price in speed.  
  627.  
  628. It also asks for a user ID, which means your name.  It's a good idea
  629. to use your full name as your user ID, because then there is less
  630. risk of other people using the wrong public key to encrypt messages
  631. to you.  Spaces and punctuation are allowed in the user ID.  It would
  632. help if you put your E-mail address in <angle brackets> after your
  633. name, like so:
  634.   
  635.     Robert M. Smith <rms@xyzcorp.com>
  636.  
  637. If you don't have an E-mail address, use your phone number or some
  638. other unique information that would help ensure that your user ID is
  639. unique.
  640.  
  641. PGP also asks for a "pass phrase" to protect your secret key in case
  642. it falls into the wrong hands.  Nobody can use your secret key file
  643. without this pass phrase.  The pass phrase is like a password, except
  644. that it can be a whole phrase or sentence with many words, spaces,
  645. punctuation, or anything else you want in it.  Don't lose this pass
  646. phrase-- there's no way to recover it if you do lose it.  This pass
  647. phrase will be needed later every time you use your secret key.  The
  648. pass phrase is case-sensitive, and should not be too short or easy to
  649. guess.  It is never displayed on the screen.  Don't leave it written
  650. down anywhere where someone else can see it, and don't store it on
  651. your computer.  If you don't want a pass phrase (You fool!), just
  652. press return (or enter) at the pass phrase prompt.
  653.  
  654. The public/secret key pair is derived from large truly random numbers
  655. derived mainly from measuring the intervals between your keystrokes
  656. with a fast timer.  The software will ask you to enter some random
  657. text to help it accumulate some random bits for the keys.  When
  658. asked, you should provide some keystrokes that are reasonably random
  659. in their timing, and it wouldn't hurt to make the actual characters
  660. that you type irregular in content as well.  Some of the randomness
  661. is derived from the unpredictability of the content of what you
  662. type.  So don't just type repeated sequences of characters.
  663.  
  664. Note that RSA key generation is a lengthy process.  It may take a few
  665. seconds for a small key on a fast processor, or quite a few minutes
  666. for a large key on an old IBM PC/XT.  PGP will visually indicate its
  667. progress during key generation.
  668.  
  669. The generated key pair will be placed on your public and secret key
  670. rings.  You can later use the -kx command option to extract (copy)
  671. your new public key from your public key ring and place it in a
  672. separate public key file suitable for distribution to your friends. 
  673. The public key file can be sent to your friends for inclusion in
  674. their public key rings.  Naturally, you keep your secret key file to
  675. yourself, and you should include it on your secret key ring.  Each
  676. secret key on a key ring is individually protected with its own pass
  677. phrase.  
  678.  
  679. Never give your secret key to anyone else.  For the same reason, don't
  680. make key pairs for your friends.  Everyone should make their own key
  681. pair.  Always keep physical control of your secret key, and don't risk
  682. exposing it by storing it on a remote timesharing computer.  Keep it
  683. on your own personal computer.
  684.  
  685. If PGP complains about not being able to find the PGP User's Guide on
  686. your computer, and refuses to generate a key pair without it, don't
  687. panic.  Just read the explanation of the NOMANUAL parameter in the
  688. section "Setting Configuration Parameters" in the Special Topics
  689. volume of the PGP User's Guide.
  690.  
  691.  
  692. Adding a Key to Your Key Ring
  693. -----------------------------
  694.  
  695. Sometimes you will want to add to your keyring a key provided to you
  696. by someone else, in the form of a keyfile.
  697.  
  698. To add a public or secret key file's contents to your public or
  699. secret key ring (note that [brackets] denote an optional field):
  700.  
  701.     pgp -ka keyfile [keyring]
  702.  
  703. The keyfile extension defaults to ".pgp".  The optional keyring file
  704. name defaults to "pubring.pgp" or "secring.pgp", depending on whether
  705. the keyfile contains a public or a secret key.  You may specify a
  706. different key ring file name, with the extension defaulting to
  707. ".pgp".
  708.  
  709. If the key is already on your key ring, PGP will not add it again. 
  710. All of the keys in the keyfile are added to the keyring, except for
  711. duplicates.
  712.  
  713. Later in the manual, we will explain the concept of certifying keys
  714. with signatures.  If the key being added has attached signatures
  715. certifying it, the signatures are added with the key.  If the key is
  716. already on your key ring, PGP just merges in any new certifying
  717. signatures for that key that you don't already have on your key ring.
  718.  
  719. PGP was originally designed for handling small personal keyrings.  If
  720. you want to handle really big keyrings, see the section on "Handling
  721. Large Public Keyrings" in the Special Topics volume.
  722.  
  723.  
  724.  
  725. Removing a Key or User ID from Your Key Ring
  726. --------------------------------------------
  727.  
  728. To remove a key or a user ID from your public key ring:
  729.  
  730.     pgp -kr userid [keyring]
  731.  
  732. This searches for the specified user ID in your key ring, and removes
  733. it if it finds a match.  Remember that any fragment of the user ID
  734. will suffice for a match.  The optional keyring file name is assumed
  735. to be literally "pubring.pgp".  It can be omitted, or you can specify
  736. "secring.pgp" if you want to remove a secret key.  You may specify a
  737. different key ring file name.  The default key ring extension is
  738. ".pgp".
  739.  
  740. If more than one user ID exists for this key, you will be asked if
  741. you want to remove only the user ID you specified, while leaving the
  742. key and its other user IDs intact.  
  743.  
  744.  
  745.  
  746. Extracting (copying) a Key from Your Key Ring
  747. ---------------------------------------------
  748.  
  749. To extract (copy) a key from your public or secret key ring:
  750.  
  751.     pgp -kx userid keyfile [keyring]
  752.  
  753. This non-destructively copies the key specified by the user ID from
  754. your public or secret key ring to the specified key file.  This is
  755. particularly useful if you want to give a copy of your public key to
  756. someone else.
  757.  
  758. If the key has any certifying signatures attached to it on your key
  759. ring, they are copied off along with the key.
  760.  
  761. If you want the extracted key represented in printable ASCII
  762. characters suitable for email purposes, use the -kxa options.
  763.  
  764.  
  765.  
  766. Viewing the Contents of Your Key Ring
  767. -------------------------------------
  768.  
  769. To view the contents of your public key ring:
  770.  
  771.     pgp -kv[v] [userid] [keyring] 
  772.  
  773. This lists any keys in the key ring that match the specified user ID
  774. substring.  If you omit the user ID, all of the keys in the key ring
  775. are listed.  The optional keyring file name is assumed to be
  776. "pubring.pgp".  It can be omitted, or you can specify "secring.pgp"
  777. if you want to list secret keys.  If you want to specify a different
  778. key ring file name, you can.  The default key ring extension is
  779. ".pgp".  
  780.  
  781. Later in the manual, we will explain the concept of certifying keys
  782. with signatures.  To see all the certifying signatures attached to
  783. each key, use the -kvv option:
  784.  
  785.     pgp -kvv [userid] [keyring] 
  786.  
  787. If you want to specify a particular key ring file name, but want to
  788. see all the keys in it, try this alternative approach:
  789.  
  790.     pgp keyfile
  791.  
  792. With no command options specified, PGP lists all the keys in
  793. keyfile.pgp, and also attempts to add them to your key ring if they
  794. are not already on your key ring.
  795.  
  796.  
  797.  
  798. How to Protect Public Keys from Tampering
  799. -----------------------------------------
  800.  
  801. In a public key cryptosystem, you don't have to protect public keys
  802. from exposure.  In fact, it's better if they are widely disseminated.
  803. But it is important to protect public keys from tampering, to make
  804. sure that a public key really belongs to whom it appears to belong to.
  805. This may be the most important vulnerability of a public-key
  806. cryptosystem.  Let's first look at a potential disaster, then at how
  807. to safely avoid it with PGP.
  808.  
  809. Suppose you wanted to send a private message to Alice.  You download
  810. Alice's public key certificate from an electronic bulletin board
  811. system (BBS).  You encrypt your letter to Alice with this public key
  812. and send it to her through the BBS's E-mail facility.
  813.  
  814. Unfortunately, unbeknownst to you or Alice, another user named
  815. Charlie has infiltrated the BBS and generated a public key of his own
  816. with Alice's user ID attached to it.  He covertly substitutes his
  817. bogus key in place of Alice's real public key.  You unwittingly use
  818. this bogus key belonging to Charlie instead of Alice's public key. 
  819. All looks normal because this bogus key has Alice's user ID.  Now
  820. Charlie can decipher the message intended for Alice because he has
  821. the matching secret key.  He may even re-encrypt the deciphered
  822. message with Alice's real public key and send it on to her so that no
  823. one suspects any wrongdoing.  Furthermore, he can even make
  824. apparently good signatures from Alice with this secret key because
  825. everyone will use the bogus public key to check Alice's signatures.
  826.  
  827. The only way to prevent this disaster is to prevent anyone from
  828. tampering with public keys.  If you got Alice's public key directly
  829. from Alice, this is no problem.  But that may be difficult if Alice
  830. is a thousand miles away, or is currently unreachable.  
  831.  
  832. Perhaps you could get Alice's public key from a mutual trusted friend
  833. David who knows he has a good copy of Alice's public key.  David
  834. could sign Alice's public key, vouching for the integrity of Alice's
  835. public key.  David would create this signature with his own secret
  836. key. 
  837.  
  838. This would create a signed public key certificate, and would show
  839. that Alice's key had not been tampered with.  This requires you have a
  840. known good copy of David's public key to check his signature.  Perhaps
  841. David could provide Alice with a signed copy of your public key also.
  842. David is thus serving as an "introducer" between you and Alice.  
  843.  
  844. This signed public key certificate for Alice could be uploaded by
  845. David or Alice to the BBS, and you could download it later.  You
  846. could then check the signature via David's public key and thus be
  847. assured that this is really Alice's public key.  No impostor can fool
  848. you into accepting his own bogus key as Alice's because no one else
  849. can forge signatures made by David.
  850.  
  851. A widely trusted person could even specialize in providing this
  852. service of "introducing" users to each other by providing signatures
  853. for their public key certificates.  This trusted person could be
  854. regarded as a "key server", or as a "Certifying Authority".  Any
  855. public key certificates bearing the key server's signature could be
  856. trusted as truly belonging to whom they appear to belong to.  All
  857. users who wanted to participate would need a known good copy of just
  858. the key server's public key, so that the key server's signatures
  859. could be verified.  
  860.  
  861. A trusted centralized key server or Certifying Authority is
  862. especially appropriate for large impersonal centrally-controlled
  863. corporate or government institutions.  Some institutional
  864. environments use hierarchies of Certifying Authorities.
  865.  
  866. For more decentralized grassroots "guerrilla style" environments,
  867. allowing all users to act as a trusted introducers for their friends
  868. would probably work better than a centralized key server.  PGP tends
  869. to emphasize this organic decentralized non-institutional approach. 
  870. It better reflects the natural way humans interact on a personal
  871. social level, and allows people to better choose who they can trust
  872. for key management.
  873.  
  874. This whole business of protecting public keys from tampering is the
  875. single most difficult problem in practical public key applications. 
  876. It is the Achilles' heel of public key cryptography, and a lot of
  877. software complexity is tied up in solving this one problem.  
  878.  
  879. You should use a public key only after you are sure that it is a good
  880. public key that has not been tampered with, and actually belongs to
  881. the person it claims to.  You can be sure of this if you got this
  882. public key certificate directly from its owner, or if it bears the
  883. signature of someone else that you trust, from whom you already have
  884. a good public key.  Also, the user ID should have the full name of
  885. the key's owner, not just her first name.
  886.  
  887. No matter how tempted you are-- and you will be tempted-- never,
  888. NEVER give in to expediency and trust a public key you downloaded
  889. from a bulletin board, unless it is signed by someone you trust. 
  890. That uncertified public key could have been tampered with by anyone,
  891. maybe even by the system administrator of the bulletin board.
  892.  
  893. If you are asked to sign someone else's public key certificate, make
  894. certain that it really belongs to that person named in the user ID of
  895. that public key certificate.  This is because your signature on her
  896. public key certificate is a promise by you that this public key
  897. really belongs to her.  Other people who trust you will accept her
  898. public key because it bears your signature.  It may be ill-advised to
  899. rely on hearsay-- don't sign her public key unless you have
  900. independent firsthand knowledge that it really belongs to her. 
  901. Preferably, you should sign it only if you got it directly from her. 
  902.  
  903. In order to sign a public key, you must be far more certain of that
  904. key's ownership than if you merely want to use that key to encrypt a
  905. message.  To be convinced of a key's validity enough to use it,
  906. certifying signatures from trusted introducers should suffice.  But
  907. to sign a key yourself, you should require your own independent
  908. firsthand knowledge of who owns that key.  Perhaps you could call the
  909. key's owner on the phone and read the key file to her to get her to
  910. confirm that the key you have really is her key-- and make sure you
  911. really are talking to the right person.  See the section called
  912. "Verifying a Public Key Over the Phone" in the Special Topics volume
  913. for further details.
  914.  
  915. Bear in mind that your signature on a public key certificate does not
  916. vouch for the integrity of that person, but only vouches for the
  917. integrity (the ownership) of that person's public key.  You aren't
  918. risking your credibility by signing the public key of a sociopath, if
  919. you were completely confident that the key really belonged to him. 
  920. Other people would accept that key as belonging to him because you
  921. signed it (assuming they trust you), but they wouldn't trust that
  922. key's owner.  Trusting a key is not the same as trusting the key's
  923. owner.
  924.  
  925. Trust is not necessarily transferable; I have a friend who I trust
  926. not to lie.  He's a gullible person who trusts the President not to
  927. lie.  That doesn't mean I trust the President not to lie.  This is
  928. just common sense.  If I trust Alice's signature on a key, and Alice
  929. trusts Charlie's signature on a key, that does not imply that I have
  930. to trust Charlie's signature on a key.  
  931.  
  932. It would be a good idea to keep your own public key on hand with a
  933. collection of certifying signatures attached from a variety of
  934. "introducers", in the hopes that most people will trust at least one
  935. of the introducers who vouch for your own public key's validity. 
  936. You could post your key with its attached collection of certifying
  937. signatures on various electronic bulletin boards.  If you sign
  938. someone else's public key, return it to them with your signature so
  939. that they can add it to their own collection of credentials for their
  940. own public key.
  941.  
  942. PGP keeps track of which keys on your public key ring are properly
  943. certified with signatures from introducers that you trust.  All you
  944. have to do is tell PGP which people you trust as introducers, and
  945. certify their keys yourself with your own ultimately trusted key.
  946. PGP can take it from there, automatically validating any other keys
  947. that have been signed by your designated introducers.  And of course
  948. you may directly sign more keys yourself.  More on this later.
  949.  
  950. Make sure no one else can tamper with your own public key ring.
  951. Checking a new signed public key certificate must ultimately depend
  952. on the integrity of the trusted public keys that are already on your
  953. own public key ring.  Maintain physical control of your public key
  954. ring, preferably on your own personal computer rather than on a
  955. remote timesharing system, just as you would do for your secret key. 
  956. This is to protect it from tampering, not from disclosure.  Keep a
  957. trusted backup copy of your public key ring and your secret key ring
  958. on write-protected media.
  959.  
  960. Since your own trusted public key is used as a final authority to
  961. directly or indirectly certify all the other keys on your key ring,
  962. it is the most important key to protect from tampering.  To detect
  963. any tampering of your own ultimately-trusted public key, PGP can be
  964. set up to automatically compare your public key against a backup copy
  965. on write-protected media.  For details, see the description of the
  966. "-kc" key ring check command in the Special Topics volume.
  967.  
  968. PGP generally assumes you will maintain physical security over your
  969. system and your key rings, as well as your copy of PGP itself.  If an
  970. intruder can tamper with your disk, then in theory he can tamper with
  971. PGP itself, rendering moot the safeguards PGP may have to detect
  972. tampering with keys.
  973.  
  974. One somewhat complicated way to protect your own whole public key ring
  975. from tampering is to sign the whole ring with your own secret key. 
  976. You could do this by making a detached signature certificate of the
  977. public key ring, by signing the ring with the "-sb" options (see the
  978. section called "Separating Signatures from Messages" in the PGP
  979. User's Guide, Special Topics volume).  Unfortunately, you would still
  980. have to keep a separate trusted copy of your own public key around to
  981. check the signature you made.  You couldn't rely on your own public
  982. key stored on your public key ring to check the signature you made
  983. for the whole ring, because that is part of what you're trying to
  984. check.  
  985.  
  986.  
  987.  
  988. How Does PGP Keep Track of Which Keys are Valid?
  989. ------------------------------------------------
  990.  
  991. Before you read this section, be sure to read the above section on 
  992. "How to Protect Public Keys from Tampering".
  993.  
  994. PGP keeps track of which keys on your public key ring are properly
  995. certified with signatures from introducers that you trust.  All you
  996. have to do is tell PGP which people you trust as introducers, and
  997. certify their keys yourself with your own ultimately trusted key.
  998. PGP can take it from there, automatically validating any other keys
  999. that have been signed by your designated introducers.  And of course
  1000. you may directly sign more keys yourself.
  1001.  
  1002. There are two entirely separate criteria PGP uses to judge a public
  1003. key's usefulness-- don't get them confused: 
  1004.  
  1005.   1)  Does the key actually belong to whom it appears to belong?  
  1006.       In other words, has it been certified with a trusted signature?
  1007.   2)  Does it belong to someone you can trust to certify other keys?
  1008.  
  1009. PGP can calculate the answer to the first question.  To answer the
  1010. second question, PGP must be explicitly told by you, the user.  When
  1011. you supply the answer to question 2, PGP can then calculate the
  1012. answer to question 1 for other keys signed by the introducer you
  1013. designated as trusted.
  1014.  
  1015. Keys that have been certified by a trusted introducer are deemed
  1016. valid by PGP.  The keys belonging to trusted introducers must
  1017. themselves be certified either by you or by other trusted
  1018. introducers.
  1019.  
  1020. PGP also allows for the possibility of you having several shades of
  1021. trust for people to act as introducers.  Your trust for a key's owner
  1022. to act as an introducer does not just reflect your estimation of
  1023. their personal integrity-- it should also reflect how competent you
  1024. think they are at understanding key management and using good
  1025. judgment in signing keys.  You can designate a person to PGP as
  1026. unknown, untrusted, marginally trusted, or completely trusted to
  1027. certify other public keys.  This trust information is stored on your
  1028. key ring with their key, but when you tell PGP to copy a key off your
  1029. key ring, PGP will not copy the trust information along with the key,
  1030. because your private opinions on trust are regarded as confidential. 
  1031.  
  1032. When PGP is calculating the validity of a public key, it examines the
  1033. trust level of all the attached certifying signatures.  It computes a
  1034. weighted score of validity-- two marginally trusted signatures are
  1035. deemed as credible as one fully trusted signature.  PGP's skepticism
  1036. is adjustable-- for example, you may tune PGP to require two fully
  1037. trusted signatures or three marginally trusted signatures to judge a
  1038. key as valid.
  1039.  
  1040. Your own key is "axiomatically" valid to PGP, needing no introducer's
  1041. signature to prove its validity.  PGP knows which public keys are
  1042. yours, by looking for the corresponding secret keys on the secret
  1043. key ring.  PGP also assumes you ultimately trust yourself to certify
  1044. other keys.
  1045.  
  1046. As time goes on, you will accumulate keys from other people that you
  1047. may want to designate as trusted introducers.  Everyone else will
  1048. each choose their own trusted introducers.  And everyone will
  1049. gradually accumulate and distribute with their key a collection of
  1050. certifying signatures from other people, with the expectation that
  1051. anyone receiving it will trust at least one or two of the signatures. 
  1052. This will cause the emergence of a decentralized fault-tolerant web
  1053. of confidence for all public keys.
  1054.  
  1055. This unique grass-roots approach contrasts sharply with Government
  1056. standard public key management schemes, such as Internet Privacy
  1057. Enhanced Mail (PEM), which are based on centralized control and
  1058. mandatory centralized trust.  The standard schemes rely on a
  1059. hierarchy of Certifying Authorities who dictate who you must trust. 
  1060. PGP's decentralized probabilistic method for determining public key
  1061. legitimacy is the centerpiece of its key management architecture. 
  1062. PGP lets you alone choose who you trust, putting you at the top of
  1063. your own private certification pyramid.  PGP is for people who prefer
  1064. to pack their own parachutes.
  1065.  
  1066.  
  1067.  
  1068. How to Protect Secret Keys from Disclosure
  1069. ------------------------------------------
  1070.  
  1071. Protect your own secret key and your pass phrase carefully.  Really,
  1072. really carefully.  If your secret key is ever compromised, you'd
  1073. better get the word out quickly to all interested parties (good luck)
  1074. before someone else uses it to make signatures in your name.  For
  1075. example, they could use it to sign bogus public key certificates,
  1076. which could create problems for many people, especially if your
  1077. signature is widely trusted.  And of course, a compromise of your own
  1078. secret key could expose all messages sent to you.
  1079.  
  1080. To protect your secret key, you can start by always keeping physical
  1081. control of your secret key.  Keeping it on your personal computer at
  1082. home is OK, or keep it in your notebook computer that you can carry
  1083. with you.  If you must use an office computer that you don't always
  1084. have physical control of, then keep your public and secret key rings
  1085. on a write-protected removable floppy disk, and don't leave it behind
  1086. when you leave the office.  It wouldn't be a good idea to allow your
  1087. secret key to reside on a remote timesharing computer, such as a
  1088. remote dial-in Unix system.  Someone could eavesdrop on your modem
  1089. line and capture your pass phrase, and then obtain your actual secret
  1090. key from the remote system.  You should only use your secret key on a
  1091. machine that you have physical control over.  
  1092.  
  1093. Don't store your pass phrase anywhere on the computer that has your
  1094. secret key file.  Storing both the secret key and the pass phrase on
  1095. the same computer is as dangerous as keeping your PIN in the same
  1096. wallet as your Automatic Teller Machine bank card.  You don't want
  1097. somebody to get their hands on your disk containing both the pass
  1098. phrase and the secret key file.  It would be most secure if you just
  1099. memorize your pass phrase and don't store it anywhere but your brain.  
  1100. If you feel you must write down your pass phrase, keep it well
  1101. protected, perhaps even more well protected than the secret key file.
  1102.  
  1103. And keep backup copies of your secret key ring-- remember, you have
  1104. the only copy of your secret key, and losing it will render useless
  1105. all the copies of your public key that you have spread throughout the
  1106. world.  
  1107.  
  1108. The decentralized non-institutional approach PGP uses to manage
  1109. public keys has its benefits, but unfortunately this also means we
  1110. can't rely on a single centralized list of which keys have been
  1111. compromised.  This makes it a bit harder to contain the damage of a
  1112. secret key compromise.  You just have to spread the word and hope
  1113. everyone hears about it.
  1114.  
  1115. If the worst case happens-- your secret key and pass phrase are both
  1116. compromised (hopefully you will find this out somehow)-- you will
  1117. have to issue a "key compromise" certificate.  This kind of
  1118. certificate is used to warn other people to stop using your public
  1119. key.  You can use PGP to create such a certificate by using the "-kd"
  1120. command.  Then you must somehow send this compromise certificate to
  1121. everyone else on the planet, or at least to all your friends and
  1122. their friends, et cetera.  Their own PGP software will install this
  1123. key compromise certificate on their public key rings and will
  1124. automatically prevent them from accidentally using your public key
  1125. ever again.  You can then generate a new secret/public key pair and
  1126. publish the new public key.  You could send out one package containing
  1127. both your new public key and the key compromise certificate for your 
  1128. old key.
  1129.  
  1130.  
  1131.  
  1132. Revoking a Public Key
  1133. ---------------------
  1134.  
  1135. Suppose your secret key and your pass phrase are somehow both
  1136. compromised.  You have to get the word out to the rest of the world,
  1137. so that they will all stop using your public key.  To do this, you 
  1138. will have to issue a "key compromise", or "key revocation" certificate
  1139. to revoke your public key.
  1140.  
  1141. To generate a certificate to revoke your own key, use the -kd
  1142. command:
  1143.  
  1144.     pgp -kd your_userid
  1145.  
  1146. This certificate bears your signature, made with the same key you are
  1147. revoking.  You should widely disseminate this key revocation
  1148. certificate as soon as possible.  Other people who receive it can add
  1149. it to their public key rings, and their PGP software then
  1150. automatically prevents them from accidentally using your old public
  1151. key ever again.  You can then generate a new secret/public key pair
  1152. and publish the new public key.
  1153.  
  1154. You may choose to revoke your key for some other reason than the
  1155. compromise of a secret key.  If so, you may still use the same
  1156. mechanism to revoke it.
  1157.  
  1158.  
  1159.  
  1160. What If You Lose Your Secret Key?
  1161. ---------------------------------
  1162.  
  1163. Normally, if you want to revoke your own secret key, you can use the
  1164. "-kd" command to issue a revocation certificate, signed with your own
  1165. secret key (see "Revoking a Public Key").  
  1166.  
  1167. But what can you do if you lose your secret key, or if your secret
  1168. key is destroyed?  You can't revoke it yourself, because you must use
  1169. your own secret key to revoke it, and you don't have it anymore.  A
  1170. future version of PGP will offer a more secure means of revoking keys
  1171. in these circumstances, allowing trusted introducers to certify that
  1172. a public key has been revoked.  But for now, you will have to get the
  1173. word out through whatever informal means you can, asking users to
  1174. "disable" your public key on their own individual public key rings.
  1175.  
  1176. Other users may disable your public key on their own public key rings
  1177. by using the "-kd" command.  If a user ID is specified that does not
  1178. correspond to a secret key on the secret key ring, the -kd command
  1179. will look for that user ID on the public key ring, and mark that
  1180. public key as disabled.  A disabled key may not be used to encrypt
  1181. any messages, and may not be extracted from the key ring with the -kx
  1182. command.  It can still be used to check signatures, but a warning is
  1183. displayed.  And if the user tries to add the same key again to his
  1184. key ring, it will not work because the disabled key is already on the
  1185. key ring.  These combined features will help curtail the further
  1186. spread of a disabled key.
  1187.  
  1188. If the specified public key is already disabled, the -kd command will
  1189. ask if you want the key reenabled.
  1190.  
  1191.  
  1192.  
  1193. Advanced Topics
  1194. ===============
  1195.  
  1196. Most of the "Advanced Topics" are covered in the "PGP User's Guide,
  1197. Volume II:  Special Topics".  But here are a few topics that bear
  1198. mentioning here.
  1199.  
  1200.  
  1201. Sending Ciphertext Through E-mail Channels: Radix-64 Format
  1202. -----------------------------------------------------------
  1203.  
  1204. Many electronic mail systems only allow messages made of ASCII text,
  1205. not the 8-bit raw binary data that ciphertext is made of.  To get
  1206. around this problem, PGP supports ASCII radix-64 format for
  1207. ciphertext messages, similar to the Internet Privacy-Enhanced Mail
  1208. (PEM) format, as well as the Internet MIME format.  This special
  1209. format represents binary data by using only printable ASCII
  1210. characters, so it is useful for transmitting binary encrypted data
  1211. through 7-bit channels or for sending binary encrypted data as normal
  1212. E-mail text.  This format acts as a form of "transport armor",
  1213. protecting it against corruption as it travels through intersystem
  1214. gateways on Internet.  PGP also appends a CRC to detect transmission
  1215. errors.
  1216.  
  1217. Radix-64 format converts the plaintext by expanding groups of 3
  1218. binary 8-bit bytes into 4 printable ASCII characters, so the file
  1219. grows by about 33%.  But this expansion isn't so bad when you
  1220. consider that the file probably was compressed more than that by PGP
  1221. before it was encrypted.
  1222.  
  1223. To produce a ciphertext file in ASCII radix-64 format, just add the
  1224. "a" option when encrypting or signing a message, like so:
  1225.  
  1226.     pgp -esa message.txt her_userid
  1227.  
  1228. This example produces a ciphertext file called "message.asc" that
  1229. contains data in a MIME-like ASCII radix-64 format.  This file can be
  1230. easily uploaded into a text editor through 7-bit channels for
  1231. transmission as normal E-mail on Internet or any other E-mail
  1232. network.
  1233.  
  1234. Decrypting the radix-64 transport-armored message is no different than
  1235. a normal decrypt.  For example:
  1236.  
  1237.     pgp message
  1238.  
  1239. PGP automatically looks for the ASCII file "message.asc" before it
  1240. looks for the binary file "message.pgp".  It recognizes that the file
  1241. is in radix-64 format and converts it back to binary before
  1242. processing as it normally does, producing as a by-product a ".pgp"
  1243. ciphertext file in binary form.  The final output file is in normal
  1244. plaintext form, just as it was in the original file "message.txt".
  1245.  
  1246. Most Internet E-mail facilities prohibit sending messages that are
  1247. more than 50000 or 65000 bytes long.  Longer messages must be broken
  1248. into smaller chunks that can be mailed separately.  If your encrypted
  1249. message is very large, and you requested radix-64 format, PGP 
  1250. automatically breaks it up into chunks that are each small enough to
  1251. send via E-mail.  The chunks are put into files named with extensions
  1252. ".as1", ".as2", ".as3", etc.  The recipient must concatenate these
  1253. separate files back together in their proper order into one big file
  1254. before decrypting it.  While decrypting, PGP ignores any extraneous
  1255. text in mail headers that are not enclosed in the radix-64 message
  1256. blocks.
  1257.  
  1258. If you want to send a public key to someone else in radix-64 format,
  1259. just add the -a option while extracting the key from your keyring.
  1260.  
  1261. If you forgot to use the -a option when you made a ciphertext file or
  1262. extracted a key, you may still directly convert the binary file into
  1263. radix-64 format by simply using the -a option alone, without any
  1264. encryption specified.  PGP converts it to a ".asc" file.
  1265.  
  1266. If you sign a plaintext file without encrypting it, PGP will normally
  1267. compress it after signing it, rendering it unreadable to the casual
  1268. human observer.  This is a suitable way of storing signed files in
  1269. archival applications.  But if you want to send the signed message as
  1270. E-mail, and the the original plaintext message is in text (not
  1271. binary) form, there is a way to send it through an E-mail channel in
  1272. such a way that the plaintext does not get compressed, and the ASCII
  1273. armor is applied only to the binary signature certificate, but not to
  1274. the plaintext message.  This makes it possible for the recipient to
  1275. read the signed message with human eyes, without the aid of PGP.  Of
  1276. course, PGP is still needed to actually check the signature.  For
  1277. further information on this feature, see the explanation of the
  1278. CLEARSIG parameter in the section "Setting Configuration Parameters"
  1279. in the Special Topics volume.
  1280.  
  1281. Sometimes you may want to send a binary data file through an E-mail
  1282. channel without encrypting or signing it with PGP.  Some people use
  1283. the Unix uuencode utility for that purpose.  PGP can also be used for
  1284. that purpose, by simply using the -a option alone, and it does a
  1285. better job than the uuencode utility.  For further details, see the
  1286. section on "Using PGP as a Better Uuencode" in the Special Topics
  1287. volume.
  1288.  
  1289.  
  1290. Environmental Variable for Path Name
  1291. ------------------------------------
  1292.  
  1293. PGP uses several special files for its purposes, such as your
  1294. standard key ring files "pubring.pgp" and "secring.pgp", the random
  1295. number seed file "randseed.bin", the PGP configuration file
  1296. "config.txt" (or "pgp.ini", or ".pgprc"), and the foreign language
  1297. string translation file "language.txt".  These special files can be
  1298. kept in any directory, by setting the environmental variable
  1299. "PGPPATH" to the desired pathname.  For example, on MSDOS, the shell
  1300. command:
  1301.  
  1302.     SET PGPPATH=C:\PGP
  1303.  
  1304. makes PGP assume that your public key ring filename is 
  1305. "C:\PGP\pubring.pgp".  Assuming, of course, that this directory
  1306. exists.  Use your favorite text editor to modify your MSDOS
  1307. AUTOEXEC.BAT file to automatically set up this variable whenever you
  1308. start up your system.  If PGPPATH remains undefined, these special
  1309. files are assumed to be in the current directory.
  1310.  
  1311.  
  1312.  
  1313. Setting Parameters in the PGP Configuration File
  1314. ------------------------------------------------
  1315.  
  1316. PGP has a number of user-settable parameters that can be defined in a
  1317. special PGP configuration text file called "config.txt", in the
  1318. directory pointed to by the shell environmental variable PGPPATH. 
  1319. Having a configuration file enables the user to define various flags
  1320. and parameters for PGP without the burden of having to always define
  1321. these parameters in the PGP command line.  
  1322.  
  1323. In the interest of complying with local operating system file naming
  1324. conventions, for Unix systems this configuration file may also be
  1325. named ".pgprc", and on MSDOS systems it may also be named "pgp.ini".
  1326.  
  1327. With these configuration parameters, for example, you can control
  1328. where PGP stores its temporary scratch files, or you can select what
  1329. foreign language PGP will use to display its diagnostics messages and
  1330. user prompts, or you can adjust PGP's level of skepticism in
  1331. determining a key's validity based on the number of certifying
  1332. signatures it has.
  1333.  
  1334. For more details on setting these configuration parameters, see the
  1335. appropriate section of the PGP User's Guide, Special Topics volume.
  1336.  
  1337.  
  1338.  
  1339. Vulnerabilities
  1340. ---------------
  1341.  
  1342. No data security system is impenetrable.  PGP can be circumvented in
  1343. a variety of ways.  Potential vulnerabilities you should be aware of
  1344. include compromising your pass phrase or secret key, public key
  1345. tampering, files that you deleted but are still somewhere on the
  1346. disk, viruses and Trojan horses, breaches in your physical security,
  1347. electromagnetic emissions, exposure on multi-user systems, traffic
  1348. analysis, and perhaps even direct cryptanalysis.
  1349.  
  1350. For a detailed discussion of these issues, see the "Vulnerabilities"
  1351. section in the PGP User's Guide, Special Topics volume.
  1352.  
  1353.  
  1354.  
  1355. Beware of Snake Oil
  1356. ===================
  1357.  
  1358. When examining a cryptographic software package, the question always
  1359. remains, why should you trust this product?  Even if you examined the
  1360. source code yourself, not everyone has the cryptographic experience
  1361. to judge the security.  Even if you are an experienced cryptographer,
  1362. subtle weaknesses in the algorithms could still elude you. 
  1363.  
  1364. When I was in college in the early seventies, I devised what I
  1365. believed was a brilliant encryption scheme.  A simple pseudorandom
  1366. number stream was added to the plaintext stream to create
  1367. ciphertext.  This would seemingly thwart any frequency analysis of
  1368. the ciphertext, and would be uncrackable even to the most resourceful
  1369. Government intelligence agencies.  I felt so smug about my
  1370. achievement.  So cock-sure.  
  1371.  
  1372. Years later, I discovered this same scheme in several introductory
  1373. cryptography texts and tutorial papers.  How nice.  Other
  1374. cryptographers had thought of the same scheme.  Unfortunately, the
  1375. scheme was presented as a simple homework assignment on how to use
  1376. elementary cryptanalytic techniques to trivially crack it.  So much
  1377. for my brilliant scheme.
  1378.  
  1379. From this humbling experience I learned how easy it is to fall into a
  1380. false sense of security when devising an encryption algorithm.  Most
  1381. people don't realize how fiendishly difficult it is to devise an
  1382. encryption algorithm that can withstand a prolonged and determined
  1383. attack by a resourceful opponent.  Many mainstream software engineers
  1384. have developed equally naive encryption schemes (often even the very
  1385. same encryption scheme), and some of them have been incorporated into
  1386. commercial encryption software packages and sold for good money to
  1387. thousands of unsuspecting users. 
  1388.  
  1389. This is like selling automotive seat belts that look good and feel
  1390. good, but snap open in even the slowest crash test.  Depending on
  1391. them may be worse than not wearing seat belts at all.  No one
  1392. suspects they are bad until a real crash.  Depending on weak
  1393. cryptographic software may cause you to unknowingly place sensitive
  1394. information at risk.  You might not otherwise have done so if you had
  1395. no cryptographic software at all.  Perhaps you may never even
  1396. discover your data has been compromised.
  1397.  
  1398. Sometimes commercial packages use the Federal Data Encryption
  1399. Standard (DES), a fairly good conventional algorithm recommended by
  1400. the Government for commercial use (but not for classified
  1401. information, oddly enough-- hmmm).  There are several "modes of
  1402. operation" the DES can use, some of them better than others.  The
  1403. Government specifically recommends not using the weakest simplest
  1404. mode for messages, the Electronic Codebook (ECB) mode.  But they do
  1405. recommend the stronger and more complex Cipher Feedback (CFB) or
  1406. Cipher Block Chaining (CBC) modes.  
  1407.  
  1408. Unfortunately, most of the commercial encryption packages I've looked
  1409. at use ECB mode.  When I've talked to the authors of a number of
  1410. these implementations, they say they've never heard of CBC or CFB
  1411. modes, and didn't know anything about the weaknesses of ECB mode. 
  1412. The very fact that they haven't even learned enough cryptography to
  1413. know these elementary concepts is not reassuring.  And they sometimes
  1414. manage their DES keys in inappropriate or insecure ways.  Also, these
  1415. same software packages often include a second faster encryption
  1416. algorithm that can be used instead of the slower DES.  The author of
  1417. the package often thinks his proprietary faster algorithm is as
  1418. secure as the DES, but after questioning him I usually discover that
  1419. it's just a variation of my own brilliant scheme from college days. 
  1420. Or maybe he won't even reveal how his proprietary encryption scheme
  1421. works, but assures me it's a brilliant scheme and I should trust it. 
  1422. I'm sure he believes that his algorithm is brilliant, but how can I
  1423. know that without seeing it?  
  1424.  
  1425. In all fairness I must point out that in most cases these terribly
  1426. weak products do not come from companies that specialize in
  1427. cryptographic technology.
  1428.  
  1429. Even the really good software packages, that use the DES in the
  1430. correct modes of operation, still have problems.  Standard DES uses a
  1431. 56-bit key, which is too small by today's standards, and may now be
  1432. easily broken by exhaustive key searches on special high-speed
  1433. machines.  The DES has reached the end of its useful life, and so has
  1434. any software package that relies on it.
  1435.  
  1436. There is a company called AccessData (87 East 600 South, Orem, Utah
  1437. 84058, phone 1-800-658-5199) that sells a package for $185 that
  1438. cracks the built-in encryption schemes used by WordPerfect, Lotus
  1439. 1-2-3, MS Excel, Symphony, Quattro Pro, Paradox, and MS Word 2.0.  It
  1440. doesn't simply guess passwords-- it does real cryptanalysis.  Some
  1441. people buy it when they forget their password for their own files. 
  1442. Law enforcement agencies buy it too, so they can read files they
  1443. seize.  I talked to Eric Thompson, the author, and he said his
  1444. program only takes a split second to crack them, but he put in some
  1445. delay loops to slow it down so it doesn't look so easy to the
  1446. customer.  He also told me that the password encryption feature of
  1447. PKZIP files can often be easily broken, and that his law enforcement
  1448. customers already have that service regularly provided to them from
  1449. another vendor. 
  1450.  
  1451. In some ways, cryptography is like pharmaceuticals.  Its integrity
  1452. may be absolutely crucial.  Bad penicillin looks the same as good
  1453. penicillin.  You can tell if your spreadsheet software is wrong, but
  1454. how do you tell if your cryptography package is weak?  The ciphertext
  1455. produced by a weak encryption algorithm looks as good as ciphertext
  1456. produced by a strong encryption algorithm.  There's a lot of snake
  1457. oil out there.  A lot of quack cures.  Unlike the patent medicine
  1458. hucksters of old, these software implementors usually don't even know
  1459. their stuff is snake oil.  They may be good software engineers, but 
  1460. they usually haven't even read any of the academic literature in
  1461. cryptography.  But they think they can write good cryptographic
  1462. software.  And why not?  After all, it seems intuitively easy to do
  1463. so.  And their software seems to work okay.    
  1464.  
  1465. Anyone who thinks they have devised an unbreakable encryption scheme
  1466. either is an incredibly rare genius or is naive and inexperienced. 
  1467. Unfortunately, I sometimes have to deal with would-be cryptographers
  1468. who want to make "improvements" to PGP by adding encryption
  1469. algorithms of their own design.
  1470.  
  1471. I remember a conversation with Brian Snow, a highly placed senior
  1472. cryptographer with the NSA.  He said he would never trust an
  1473. encryption algorithm designed by someone who had not "earned their
  1474. bones" by first spending a lot of time cracking codes.  That did make
  1475. a lot of sense.  I observed that practically no one in the commercial
  1476. world of cryptography qualified under this criterion.  "Yes", he said
  1477. with a self assured smile, "And that makes our job at NSA so much
  1478. easier."  A chilling thought.  I didn't qualify either.
  1479.  
  1480. The Government has peddled snake oil too.  After World War II, the US
  1481. sold German Enigma ciphering machines to third world governments.
  1482. But they didn't tell them that the Allies cracked the Enigma code
  1483. during the war, a fact that remained classified for many years.  Even
  1484. today many Unix systems worldwide use the Enigma cipher for file
  1485. encryption, in part because the Government has created legal
  1486. obstacles against using better algorithms.  They even tried to
  1487. prevent the initial publication of the RSA algorithm in 1977.  And
  1488. they have squashed essentially all commercial efforts to develop
  1489. effective secure telephones for the general public. 
  1490.  
  1491. The principal job of the US Government's National Security Agency is
  1492. to gather intelligence, principally by covertly tapping into people's
  1493. private communications (see James Bamford's book, "The Puzzle
  1494. Palace").  The NSA has amassed considerable skill and resources for
  1495. cracking codes.  When people can't get good cryptography to protect
  1496. themselves, it makes NSA's job much easier.  NSA also has the
  1497. responsibility of approving and recommending encryption algorithms. 
  1498. Some critics charge that this is a conflict of interest, like putting
  1499. the fox in charge of guarding the hen house.  NSA has been pushing a
  1500. conventional encryption algorithm that they designed, and they won't
  1501. tell anybody how it works because that's classified.  They want
  1502. others to trust it and use it.  But any cryptographer can tell you
  1503. that a well-designed encryption algorithm does not have to be
  1504. classified to remain secure.  Only the keys should need protection. 
  1505. How does anyone else really know if NSA's classified algorithm is
  1506. secure?  It's not that hard for NSA to design an encryption algorithm
  1507. that only they can crack, if no one else can review the algorithm. 
  1508. Are they deliberately selling snake oil? 
  1509.  
  1510. There are three main factors that have undermined the quality of
  1511. commercial cryptographic software in the US.  The first is the
  1512. virtually universal lack of competence of implementors of commercial
  1513. encryption software (although this is starting to change since the
  1514. publication of PGP).  Every software engineer fancies himself a
  1515. cryptographer, which has led to the proliferation of really bad
  1516. crypto software.  The second is the NSA deliberately and
  1517. systematically suppressing all the good commercial encryption
  1518. technology, by legal intimidation and economic pressure.  Part of
  1519. this pressure is brought to bear by stringent export controls on
  1520. encryption software which, by the economics of software marketing,
  1521. has the net effect of suppressing domestic encryption software.  The
  1522. other principle method of suppression comes from the granting all the
  1523. software patents for all the public key encryption algorithms to a
  1524. single company, affording a single choke point to suppress the spread
  1525. of this technology.  The net effect of all this is that before PGP
  1526. was published, there was almost no highly secure general purpose
  1527. encryption software available in the US.
  1528.  
  1529. I'm not as certain about the security of PGP as I once was about my
  1530. brilliant encryption software from college.  If I were, that would be
  1531. a bad sign.  But I'm pretty sure that PGP does not contain any
  1532. glaring weaknesses (although it may contain bugs).  The crypto
  1533. algorithms were developed by people at high levels of civilian
  1534. cryptographic academia, and have been individually subject to
  1535. extensive peer review.  Source code is available to facilitate peer
  1536. review of PGP and to help dispel the fears of some users.  It's
  1537. reasonably well researched, and has been years in the making.  And I
  1538. don't work for the NSA.  I hope it doesn't require too large a "leap
  1539. of faith" to trust the security of PGP.
  1540.  
  1541.  
  1542.  
  1543. Notice to Macintosh Users
  1544. =========================
  1545.  
  1546. PGP was originally developed for MSDOS and Unix machines.  There is
  1547. also an Apple Macintosh version of PGP.  This manual is written for
  1548. the MSDOS/Unix versions of PGP, which use a command-line interface
  1549. for all the PGP functions.  On the Mac, all the PGP functions are
  1550. accessed through pull-down menus and dialog boxes.  There is also
  1551. on-line help on the Mac for how to use MacPGP, and there should be
  1552. some Mac-specific user documentation included in the MacPGP release
  1553. package, in addition to this manual.
  1554.  
  1555. Almost all good Mac software applications are written from scratch
  1556. for the Mac, not simply ported there from other operating systems.  
  1557. Unfortunately, the current Mac version of PGP was not designed for
  1558. the Mac from scratch.  It was ported from the MSDOS/Unix version to
  1559. the Mac by Zbigniew Fiedorwicz.  Since the MSDOS/Unix version of PGP
  1560. was not designed for a GUI (graphical user interface), porting to the
  1561. Mac was not an easy task, and many bugs still remain.  An all-new
  1562. version of PGP is under development, designed for easy adaptation to
  1563. a GUI.  A new Mac version will be developed from this new PGP source
  1564. code.  It will be more Mac-like, and more reliable.  Despite the bugs
  1565. in the current version of MacPGP, it is important to note that if
  1566. Zbigniew had waited for this all-new version of PGP to be developed
  1567. before he ported PGP to the Mac, the world would have been deprived
  1568. of a Mac version of PGP for far too long.
  1569.  
  1570.  
  1571.  
  1572. PGP Quick Reference
  1573. ===================
  1574.  
  1575. Here's a quick summary of PGP commands.
  1576.  
  1577.  
  1578. To encrypt a plaintext file with the recipient's public key:
  1579.     pgp -e textfile her_userid
  1580.  
  1581. To sign a plaintext file with your secret key:
  1582.     pgp -s textfile [-u your_userid]
  1583.  
  1584. To sign a plaintext ASCII text file with your secret key, producing a
  1585. signed plaintext message suitable for sending via E-mail:
  1586.     pgp -sta textfile [-u your_userid]
  1587.  
  1588. To sign a plaintext file with your secret key, and then encrypt it 
  1589. with the recipient's public key:
  1590.     pgp -es textfile her_userid [-u your_userid]
  1591.  
  1592. To encrypt a plaintext file with just conventional cryptography, type:
  1593.     pgp -c textfile
  1594.  
  1595. To decrypt an encrypted file, or to check the signature integrity of a
  1596. signed file:
  1597.     pgp ciphertextfile [-o plaintextfile]
  1598.  
  1599. To encrypt a message for any number of multiple recipients:
  1600.     pgp -e textfile userid1 userid2 userid3
  1601.  
  1602. --- Key management commands:
  1603.  
  1604. To generate your own unique public/secret key pair:
  1605.     pgp -kg
  1606.  
  1607. To add a public or secret key file's contents to your public or
  1608. secret key ring:
  1609.     pgp -ka keyfile [keyring]
  1610.  
  1611. To extract (copy) a key from your public or secret key ring:
  1612.     pgp -kx userid keyfile [keyring]
  1613. or: pgp -kxa userid keyfile [keyring]
  1614.  
  1615. To view the contents of your public key ring:
  1616.     pgp -kv[v] [userid] [keyring] 
  1617.  
  1618. To view the "fingerprint" of a public key, to help verify it over 
  1619. the telephone with its owner:
  1620.     pgp -kvc [userid] [keyring]
  1621.  
  1622. To view the contents and check the certifying signatures of your 
  1623. public key ring:
  1624.     pgp -kc [userid] [keyring] 
  1625.  
  1626. To edit the userid or pass phrase for your secret key:
  1627.     pgp -ke userid [keyring]
  1628.  
  1629. To edit the trust parameters for a public key:
  1630.     pgp -ke userid [keyring]
  1631.  
  1632. To remove a key or just a userid from your public key ring:
  1633.     pgp -kr userid [keyring]
  1634.  
  1635. To sign and certify someone else's public key on your public key ring:
  1636.     pgp -ks her_userid [-u your_userid] [keyring]
  1637.  
  1638. To remove selected signatures from a userid on a keyring:
  1639.     pgp -krs userid [keyring]
  1640.  
  1641. To permanently revoke your own key, issuing a key compromise 
  1642. certificate:
  1643.     pgp -kd your_userid
  1644.  
  1645. To disable or reenable a public key on your own public key ring:
  1646.     pgp -kd userid
  1647.  
  1648. --- Esoteric commands:
  1649.  
  1650. To decrypt a message and leave the signature on it intact:
  1651.     pgp -d ciphertextfile
  1652.  
  1653. To create a signature certificate that is detached from the document:
  1654.     pgp -sb textfile [-u your_userid]
  1655.  
  1656. To detach a signature certificate from a signed message:
  1657.     pgp -b ciphertextfile
  1658.  
  1659. --- Command options that can be used in combination with other 
  1660. command options (sometimes even spelling interesting words!):
  1661.  
  1662. To produce a ciphertext file in ASCII radix-64 format, just add the
  1663. -a option when encrypting or signing a message or extracting a key:
  1664.     pgp -sea textfile her_userid
  1665. or: pgp -kxa userid keyfile [keyring]
  1666.  
  1667. To wipe out the plaintext file after producing the ciphertext file,
  1668. just add the -w (wipe) option when encrypting or signing a message:
  1669.     pgp -sew message.txt her_userid
  1670.  
  1671. To specify that a plaintext file contains ASCII text, not binary, and
  1672. should be converted to recipient's local text line conventions, add
  1673. the -t (text) option to other options:
  1674.     pgp -seat message.txt her_userid
  1675.  
  1676. To view the decrypted plaintext output on your screen (like the
  1677. Unix-style "more" command), without writing it to a file, use 
  1678. the -m (more) option while decrypting:
  1679.     pgp -m ciphertextfile
  1680.  
  1681. To specify that the recipient's decrypted plaintext will be shown
  1682. ONLY on her screen and cannot be saved to disk, add the -m option:
  1683.     pgp -steam message.txt her_userid
  1684.  
  1685. To recover the original plaintext filename while decrypting, add 
  1686. the -p option:
  1687.     pgp -p ciphertextfile
  1688.  
  1689. To use a Unix-style filter mode, reading from standard input and
  1690. writing to standard output, add the -f option:
  1691.     pgp -feast her_userid <inputfile >outputfile
  1692.  
  1693.  
  1694.  
  1695.  
  1696. Legal Issues
  1697. ============
  1698.  
  1699. For detailed information on PGP™ licensing, distribution,
  1700. copyrights, patents, trademarks, liability limitations, and export
  1701. controls, see the "Legal Issues" section in the "PGP User's Guide,
  1702. Volume II: Special Topics".
  1703.  
  1704. PGP uses a public key algorithm claimed by U.S. patent #4,405,829. 
  1705. The exclusive licensing rights to this patent are held by a company
  1706. called Public Key Partners (PKP), and you may be infringing the
  1707. patent if you use PGP in the USA without a license.  These issues are
  1708. detailed in the Volume II manual, and in the RSAREF license that
  1709. comes with the freeware version of PGP.  PKP has licensed others to
  1710. practice the patent, including a company known as ViaCrypt, in
  1711. Phoenix, Arizona.  ViaCrypt sells a fully licensed version of PGP. 
  1712. ViaCrypt may be reached at 602-944-0773.
  1713.  
  1714. PGP is "guerrilla" freeware, and I don't mind if you distribute it
  1715. widely.  Just don't ask me to send you a copy.  Instead, you can look
  1716. for it yourself on many BBS systems and a number of Internet FTP
  1717. sites.  But before you distribute PGP, it is essential that you
  1718. understand the U.S. export controls on encryption software.
  1719.  
  1720.  
  1721.  
  1722. Acknowledgments
  1723. ================
  1724.  
  1725. Formidable obstacles and powerful forces have been arrayed to stop
  1726. PGP.  Dedicated people are helping to overcome these obstacles.  PGP
  1727. has achieved notoriety as "underground software", and bringing PGP
  1728. "above ground" as fully licensed freeware has required patience and
  1729. persistence.  I'd especially like to thank Hal Abelson, Jeff
  1730. Schiller, Brian LaMacchia, and Derek Atkins at MIT for their
  1731. determined efforts.  I'd also like to thank Jim Bruce and David
  1732. Litster in the MIT administration and Bob Prior and Terry Ehling at
  1733. the MIT Press.  And I'd like to thank my entire legal defense team,
  1734. whose job is not over yet.  I used to tell a lot of lawyer jokes,
  1735. before I encountered so many positive examples of lawyers in my legal
  1736. defense team, most of whom work pro bono.
  1737.  
  1738. The development of PGP has turned into a remarkable social
  1739. phenomenon, whose unique political appeal has inspired the collective
  1740. efforts of an ever-growing number of volunteer programmers.  Remember
  1741. that children's story called "Stone Soup"?
  1742.  
  1743. I'd like to thank the following people for their contributions to the
  1744. creation of Pretty Good Privacy.  Although I was the author of PGP
  1745. version 1.0, major parts of later versions of PGP were implemented by
  1746. an international collaborative effort involving a large number of
  1747. contributors, under my design guidance.  
  1748.  
  1749. Branko Lankester, Hal Finney and Peter Gutmann all contributed a huge
  1750. amount of time in adding features for PGP 2.0, and ported it to Unix
  1751. variants.
  1752.  
  1753. Hugh Kennedy ported it to VAX/VMS, Lutz Frank ported it to the Atari
  1754. ST, and Cor Bosman and Colin Plumb ported it to the Commodore Amiga.
  1755.  
  1756. Translation of PGP into foreign languages was done by Jean-loup
  1757. Gailly in France, Armando Ramos in Spain, Felipe Rodriquez Svensson
  1758. and Branko Lankester in The Netherlands, Miguel Angel Gallardo in
  1759. Spain, Hugh Kennedy and Lutz Frank in Germany, David Vincenzetti in
  1760. Italy, Harry Bush and Maris Gabalins in Latvia, Zygimantas Cepaitis
  1761. in Lithuania, Peter Suchkow and Andrew Chernov in Russia, and
  1762. Alexander Smishlajev in Esperantujo.  Peter Gutmann offered to
  1763. translate it into New Zealand English, but we finally decided PGP
  1764. could get by with US English.
  1765.  
  1766. Jean-loup Gailly, Mark Adler, and Richard B. Wales published the ZIP
  1767. compression code, and granted permission for inclusion into PGP.  The
  1768. MD5 routines were developed and placed in the public domain by Ron
  1769. Rivest.  The IDEA™ cipher was developed by Xuejia Lai and James L.
  1770. Massey at ETH in Zurich, and is used in PGP with permission from
  1771. Ascom-Tech AG. 
  1772.  
  1773. Charlie Merritt originally taught me how to do decent multiprecision 
  1774. arithmetic for public key cryptography, and Jimmy Upton contributed a
  1775. faster multiply/modulo algorithm.  Thad Smith implemented an even
  1776. faster modmult algorithm.  Zhahai Stewart contributed a lot of useful
  1777. ideas on PGP file formats and other stuff, including having more than
  1778. one user ID for a key.  I heard the idea of introducers from Whit
  1779. Diffie.  Kelly Goen did most of the work for the initial electronic
  1780. publication of PGP 1.0.
  1781.  
  1782. Various contributions of coding effort also came from Colin Plumb,
  1783. Derek Atkins, and Castor Fu.  Other contributions of effort, coding
  1784. or otherwise, have come from Hugh Miller, Eric Hughes, Tim May,
  1785. Stephan Neuhaus, and too many others for me to remember right now. 
  1786. Zbigniew Fiedorwicz did the first Macintosh port.
  1787.  
  1788. Since the release of PGP 2.0, many other programmers have sent in
  1789. patches and bug fixes and porting adjustments for other computers.
  1790. There are too many to individually thank here.
  1791.  
  1792. Just as in the "Stone Soup" story, it is getting harder to peer
  1793. through the thick soup to see the stone at the bottom of the pot that
  1794. I dropped in to start it all off.
  1795.  
  1796.  
  1797.  
  1798. About the Author
  1799. ================
  1800.  
  1801. Philip Zimmermann is a software engineer consultant with 19 years
  1802. experience, specializing in embedded real-time systems, cryptography,
  1803. authentication, and data communications.  Experience includes design
  1804. and implementation of authentication systems for financial
  1805. information networks, network data security, key management
  1806. protocols, embedded real-time multitasking executives, operating
  1807. systems, and local area networks.  
  1808.  
  1809. Custom versions of cryptography and authentication products and 
  1810. public key implementations such as the NIST DSS are available from
  1811. Zimmermann, as well as custom product development services.  His
  1812. consulting firm's address is: 
  1813.  
  1814. Boulder Software Engineering
  1815. 3021 Eleventh Street
  1816. Boulder, Colorado 80304  USA
  1817. Phone: 303-541-0140 (10:00am - 7:00pm Mountain Time)
  1818. Fax: arrange by phone
  1819. Internet:  prz@acm.org
  1820.  
  1821.